home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / c1aft100.arc / C1AFT.DOC < prev    next >
Text File  |  1991-09-30  |  12KB  |  262 lines
  1.  
  2.  
  3.  
  4.                                C1AFT.ASX
  5.  
  6.  
  7.                    A Procomm Plus Script For Unattended
  8.                       MarkMail Packet Transfers And
  9.                         Pro Door File Downloading
  10.                              From CHANNEL 1
  11.  
  12.                   For use with PROCOMM PLUS version 2.01
  13.  
  14.                   (C) Copyright  1991  Patrick Bresnahan
  15.  
  16.  
  17.  
  18.   Requirements:
  19.  
  20.     * IBM compatible computer
  21.     * Procomm Plus communications software version 2.01
  22.         C1AFT.ASX is a compiled ASPECT file for use with Procomm Plus.
  23.         Although the script functions normally when used with version 2.0
  24.         it will not compile properly with this version and therefore
  25.         it is recommended that Procomm Plus version 2.01 be used. Registered
  26.         users of 2.0 can receive free, the maintenance release version 2.01
  27.         from Datastorm Technologies, Inc.
  28.     * Floppy disk drive, or Hard drive recommended
  29.     * At least 256k RAM
  30.     * You must be a registered user of CHANNEL 1
  31.     * You must have previously set up your MarkMail account on Channel 1
  32.       which is in door 8.
  33.     * This script performs better when a disk cache is available.  This is not
  34.       a requirement, but it is a suggested option.   A disk cache improves the
  35.       performance of the script during data entry, making the screen image
  36.       display noticeably quicker.
  37.  
  38.  
  39.   Features:
  40.  
  41.     * Allows you to Set the time of day to begin file transfers
  42.     * Automatically renames downloaded QWK packets
  43.     * Renames successfully uploaded REP packets
  44.     * Batch downloads up to 10 different file specifications
  45.     * Choose whether to automatically log off system
  46.     * Completely unattended file transfers
  47.     * MarkMail message Pointer reset
  48.     * Zip directory scan
  49.  
  50.        PROCOMM PLUS is a copyright of Datastorm Technologies, Inc
  51.        MARKMAIL is a copyright of Mark Turner
  52.        PRO DOOR is a copyright of Samuel Smith
  53.        CHANNEL 1 is a trademark of Channel 1 Communications
  54.  
  55.  
  56.          C1AFT.ASX script is provided on an "as is" basis without
  57.          warranty of any kind expressed or implied. In no event will
  58.          Patrick Bresnahan be liable to you for any damages, including
  59.          any lost profits, lost savings or other incidental or con-
  60.          sequential damages arising out of the use of or inability to
  61.          use this script.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. page 2                                                     C1AFT100.DOC
  71.  
  72.  
  73.  Getting Started:
  74.  
  75. To run this script, you must first copy the file C1AFT.ASX to the directory
  76. where your Procomm Plus files are kept.  Then run PCPLUS.EXE, and from
  77. terminal mode press <ALT><F5>, and then <ENTER> to get a list of available
  78. script files.  Select the file C1AFT, and press <ENTER>.  Once the script
  79. begins, it sets the terminal mode to 25 lines and 80 columns.  Your original
  80. terminal options will be restored when the script ends.
  81.  
  82. The script reads in information from a configuration file, C1AFT.CNF.  The
  83. configuration file must be in the same directory that you start the script
  84. from, otherwise the file will not be found.  If you are running the script for
  85. the first time, this file will not yet exist and you will need to edit several
  86. of the configuration options before allowing the script to call Channel 1.
  87.  
  88.  
  89.  Editing Options:
  90.  
  91. To edit, use the up/down arrows to highlight an option then press <ENTER>.
  92.  
  93.     SET TIME: This is the time, in 24 hour format, that the call to Channel 1
  94. will be made.  Setting the time is the only way to initiate a call.  To view
  95. the current time, press <ESC> until the box with the current time is
  96. displayed.
  97.  
  98.     SEND REP on/off: Toggle this option on or off by pressing <ENTER> and then
  99. using the space bar.  <ENTER> again to accept.  When set "on", the script will
  100. upload your REP mail packet to the MARKMAIL door.  The name of your REP packet
  101. must be specified in the "REP Packet Name" option and reside in the upload
  102. directory, as entered in the "Upload Directory" option.  If the packet is
  103. successfully transferred, it will be renamed using the conventions explained
  104. later in the "Renaming Files" section.  Renaming the file prevents from
  105. inadvertently sending it more than once.
  106.  
  107.     RECEIVE QWK on/off: Toggle this option on or off.  When set "on", the
  108. script will download your mail packet from the MARKMAIL door.  Once the mail
  109. packet is successfully downloaded, it will be renamed as mentioned in the
  110. "Renaming Files" section.  The packet will be downloaded into the default
  111. download directory, as specified in the PCPLUS SETUP options.  This directory
  112. will generally be the default download directory of your offline reader, too.
  113.  
  114.     DOWNLOAD on/off: Again, toggle this option on or off.  When "on", the
  115. files that you have listed in the Download List will be downloaded to you from
  116. Channel 1.  These files will be transferred from ProDoor, and will be
  117. downloaded into the PCPLUS default download directory.  More information on
  118. this can be found in the "Function Keys" section under "D/L List".
  119.  
  120.     DIR SCAN on/off: Toggles on or off.  When "on", the script will use the
  121. information provided in the SCAN LIST to do a Zip Directory Scan of the
  122. Channel 1 file directories.  The output of this directory scan will be written
  123. to a file with the extension of SCN, and placed in the directory from which
  124. this script was started.
  125.  
  126.     POINTER RESET: The value entered here will be used to set your MARKMAIL
  127. message read pointers.  This will set your pointers back by the specified
  128. amount.  For example, entering 5 would set your pointers in every conference
  129. that you read, back 5 from the last message.  Downloading a mail packet would
  130. then give you 5 messages in each conference.  If this field is left blank, no
  131. adjustment will be made.
  132.  
  133.  
  134.  
  135.  
  136. page 3                                                     C1AFT100.DOC
  137.  
  138.  
  139.     AUTO LOG-OFF: This option also toggles on or off.  When "on", the script
  140. will complete all set tasks, log off from Channel 1, and exit after
  141. "NO CARRIER" is detected.  When set to "off" the script will complete all
  142. tasks, return to the main board and then exit leaving you connected to
  143. Channel 1.  When the script exits, it will restore your original terminal mode
  144. options and colors.
  145.  
  146.     PROTOCOL: This field specifies the transfer protocol used for all file
  147. transfers.  Although, this field can be edited, ZMODEM has been hard coded
  148. into the script.  In other words, you must use Zmodem.  Your default protocol
  149. in MARKMAIL must also be set to Zmodem.
  150.  
  151.     DIALING DIRECTORY #: This is the number of the dialing directory entry
  152. for Channel 1.  The script uses the information contained in this entry to
  153. dial Channel 1 and set terminal options and baud rate.
  154.  
  155.     REP PACKET NAME: This is the filename with extension of the mail packet
  156. you will be uploading to the MARKMAIL door.  The default for this entry is
  157. CHANNEL1.REP but allows you to modify it.  Your offline reader will create
  158. this CHANNEL1.REP file for you.
  159.  
  160.     UPLOAD DIRECTORY: This specifies the complete drive and path of the
  161. directory where the above REP PACKET can be found.  The script will attempt to
  162. validate this entry and will not accept an invalid path.  Generally, this will
  163. be the upload directory of your offline mail reader.
  164.  
  165.     FIRST & LAST NAME / PASSWORD: These are the names and password you use
  166. when logging onto Channel 1.
  167.  
  168.  
  169.  
  170.  Function Keys:
  171.  
  172.     F2 Save: Pressing F2 allows you to save your input to the configuration
  173. file, C1AFT.CNF.  All options are saved, and also all files in the DownLoad
  174. list will be saved as well as all information entered in the Scan File list.
  175.  
  176.     F4 D/L List: This is the download list.  Here you enter all files that you
  177. want to download from Channel 1.  File names can include wildcards and if a
  178. file extension is not given, ZIP will be assumed.  If it is necessary to be in
  179. a specific conference in order to download the specified file, enter the
  180. conference number, also.  It is not necessary to group files in the download
  181. list according to conference.  The script will download all files listed, up
  182. to the first blank line in the download list.
  183.  
  184.     F5 Restore: The restore function allows you to read in information
  185. previously saved in the configuration file.
  186.  
  187.     F6 Quit: Pressing F6 exits the script, and returns you to terminal mode.
  188. Until a connection is made with Channel 1, this is the only way to exit the
  189. script.  After a connection is made, you can exit the script by pressing the
  190. <ESC> key.  To abort a dialing attempt, it will be necessary to press <ESC> or
  191. the space bar until the SET TIME and the system time are no longer the same.
  192.  
  193.     F7 Scan List: The Scan List allows you to do a Zip Directory Scan of the
  194. files in the Channel 1 file directories.  In the Keyword field enter the text
  195. to scan for.  The logical operators, || (OR) and && (AND) can be used.  In the
  196. Directories field, enter the number of the particular directories you want to
  197. scan.
  198.  
  199.  
  200.  
  201.  
  202. Page 4                                                     C1AFT100.DOC
  203.  
  204.  
  205. The Conference field allows you to enter a specific conference before doing
  206. the directory scan.  Blank lines in the Scan List are ignored.  The output of
  207. the Directory Scan is written to a file in your systems current directory.
  208. The file name will be:    mmmdd?.scn
  209. mmm is the current month, dd is the current date, and ? will be a letter from
  210. A to Z.
  211.  
  212.     <ESC>: The escape key has several different meanings, but it basically
  213. moves you from place to place within the script.
  214.  
  215.  
  216.  
  217.     Renaming Files:
  218.  
  219. The script creates or renames files according to the following format.
  220.             mmmdd?.xxx
  221. mmm is the current month, dd is the current date, ? is a letter from A to Z,
  222. and xxx is the file extension of the original file.  Downloaded mail packets
  223. will have the file extension of QWK.  Mail packets that you send to Channel 1
  224. will keep the same file extension that you originally specified for it, but
  225. generally this will be REP.  Scan List files have the extension SCN.  This
  226. renaming sequence allows you to have up to 26 different files per day.  For
  227. example, if you received 3 different mail packets in one day from Channel 1 on
  228. July first, they would be renamed jul01a.qwk
  229.                                   jul01b.qwk
  230.                                   jul01c.qwk
  231. All uploaded mail packets are immediately renamed after being successfully
  232. transferred.  This helps to prevent from accidentally uploading the same mail
  233. packet more than once.
  234.  
  235.  
  236.  
  237.     Calling Channel 1:
  238.  
  239. Before attempting to use the script to call Channel 1, it will be necessary to
  240. edit the following options:     Set Time
  241.                                 Dialing Directory #
  242.                                 First Name
  243.                                 Last Name
  244.                                 Password
  245. Setting the time of day is the only way to begin a call.  Once all options
  246. have been selected press <ESC> until the box with the current system time is
  247. displayed.  This box will also display the name and phone number of the
  248. selected dialing directory entry.  The script will only make the call when
  249. this box is being displayed.
  250. The script can be setup to function as an auto-logon script by setting all
  251. switches to OFF.
  252.  
  253.  
  254. Any comments, criticisms, or suggestions can be made to:
  255.     Patrick Bresnahan
  256.     Po Box 3072
  257.     Edgartown, Ma  02539
  258. I also regularly read the Main Board conference on Channel 1 and the Procomm
  259. conference on RelayNet and can be messaged there.
  260.  
  261.  
  262.